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102 
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1 collection c-myhomepage \ 

2 coil-type cf-web-page [ 

3 coll-desc A sample homepage collection | 

4 end-collection ! 
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FIG. 8 

1 /* collection data structure */ 

2 collection-info { 

3 + specifierjnfo 

4 + coil-type-indicator 

5 + other specifier information . . . 

6 + contentjnfo 

7 + contentjocationjnfo ... 

8 + contentjmembers . . . 

9 + other content information... 

10 + other collection structure information... 

11 } 



FIG. 9 

1 /* collection type definition data structure */ 

2 collection-type-definition-info { 

3 + coil-type-name 

4 + collection internal structure info ... 

5 + collection content location info ... 

6 + collection content type recognition info . . . 

7 + other collection type definition information... 

8 } 
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FIG. 10 

KEY VALUE 

1 /* collection type internal structure definitions 7 

2 dir_sourceJiles ./s 

3 dir_doc_files ./doc 

4 /* content location definitions (per-type content links) */ 

5 content_subtree_http http://host.com/some/dir/name 

6 content_subtreeJtp ftp://host.com/some/dir/name 

7 content_subtree_nfs /some/local/directory/name 

8 /* content type recognition definitions */ 

9 content_poiicy subtree_below_cspec_file 

10 content Jilejype .c file_cpp 

11 content Jilejype .c file_c 

12 content Jilejype .h file_c_include 

13 content_file_type .doc file_ms_word 

14 contenMileJype .html filejitml 

15 contenMileJype .xls file_ms_excel 

16 /* collection processing definitions */ 

17 compile_cJiles yes 

18 compiler_windows vc++ 

19 compiler_unix gcc 

20 build platforms Win98, Win2000, gnulinux 

21 process files compile link 

22 link libraries stdio math sock 

23 /* results dispatching definitions 7 

24 resultsjtpjiost ftp.output.com 

25 results_ftp_dir c:\ftphome\collection\results 
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FIG. 12 

1 /* simplified algorithm for collection makefile generator */ 

2 Call get runtime info to get invocation parameters 

3 Call collection content classifier to classify collection content 

4 Call collection makefile generator manager to generate 

a complete makefile, passing classifier information as input 
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FIG. 14 

1 /* simplified algorithm for collection makefile manager */ 

2 Process collection-level fragments 

3 Process fragments from collection type definition 

4 Process fragments from collection specifier 

5 Determine relative build order among multiple products 

6 Determine number, names of coll-level parallel build targets 

7 Loop over each product in collection 

8 Process each product by calling product makefile manager 
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FIG. 16 

1 /* simplified algorithm for processing one product */ 

2 Process product-level fragments 

3 Process fragments from product type definition 

4 Process fragments from product section of collection specifier 

5 Determine relative build order among content files for product 

6 Determine number, names of product-level parallel build targets 

7 Loop over each content file 

8 Process each content file by calling file makefile manager 
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FIG. 18 

1 /* simplified algorithm for processing one content file */ 

2 Calculate include file search directories 

3 Process fragments from content type definition 

4 Process fragments from action type definition 
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FIG. 20 



1 /* simplified algorithm for processing one fragment */ 

2 Substitute replacement values for placeholder strings 

3 Insert substituted fragment into makefile data structure 
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FIG. 21 

1 c:\collections 



2 c-my-example 

3 cspec 

4 s 

5 pi 

6 cmdline.h 

7 win98 

8 cmdline.c 

9 gnulinux2 

10 cmdline.c 

11 lib 

12 pi 

13 libfuns.h 

14 libfuns.c 



FIG. 22 

1 cspec: 

2 collection c-my-example 

3 coil-type ct-program 

4 coll-desc A multi-platform C program with library. 

5 end-collection 

6 product myprog 

7 prod-type pt-program 

8 prod-desc A program product. 

9 libs team-lib gnulinux-lib 

10 end-product 

11 product mylibrary 

12 prod-type pt-library 

13 prod-desc A library product. 

14 end-product 
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FIG. 23 

1 /* classification output for gnulinux2 platform */ 

2 collection c-my-example 

3 coil-type ct-program 

4 ... other coll classification info 



5 


/* classification info for a program product */ 


6 


product 


myprog 


7 


prod-type 


pt-program 


8 


content 


cmdline.h 


9 


content-path 


../s/pi/cmdline.h 


10 


content-type 


ctype-c-header 


11 


content-language 


c 


12 


end-content 




13 


content 


cmdline.c 


14 


content-path 


../s/gnulinux2/cmdline. 


15 


content-type 


ctype-c-source 


16 


content-language 


c 


17 


content-dep 


../s/pi/cmdline.h 


18 


content-dep 


../lib/pi/libfuns.h 


19 


content-dep 


external-incl-file.h 


20 


content-dep 


team-incUn 


21 


end-content 




22 


end-product 
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FIG. 24 



1 
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/* classification output */ 


2 


collection 


c-my-example 


3 


... /* classification info for the host collection */ 


4 


... /* classification info for the program product */ 


5 


/* classification info for a library product */ 


6 


product 


mylibrary 
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prod-type 


pt-library 


10 


content 


libfuns.h 


11 


content-path 


../lib/pi/libfuns.h 
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content-type 
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13 
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end-content 




16 


content 


libfuns.c 


17 


content-path 
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23 end-product 
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FIG. 25 

1 collection type definition information 

2 product type definition information 

3 content type definition information 

4 action type definition information 



5 cspec: 

6 coil-type ct-program 

7 index-coll-types.tbl: 

8 ct-program ct-program.def 

9 ct-web-page ct-web-page.def 

10 ct-program.def: 

1 1 product-type-index index-product-types.tbl 

1 2 index-product-types.tbl: 

1 3 pt-program pt-program.def 

14 pt-program.def: 

1 5 content-type-index index-content-types.tbl 

1 6 index-content-types.tbl 

1 7 ctype-c-source content-c.def 

18 content-c.def: 

1 9 action-type-index index-action-types.tbl 

20 index-action-types.def: 

21 action-c-source action-c-source.def 

22 action-c-source.def: 

23 ... action definition information 
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FIG. 26 



A 
1 


index-coll-types.tbl: 




2 


ct-program 


ci- prog r a m . u er 


3 


ct-library 


ct-library.def 


4 


ct-doc-html 


ct-html.def 


0 


ct-program.def: 




6 
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service 
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service 


svc-coll-target-defaults 


15 


service 


svc-coll-target-others 


16 


parallelism-max 
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17 


... other collection type info 
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FIG. 27 



1 index-prod-program.tbl: 

2 pt-program 

3 pt-program-java 

4 pt-program-unix 

5 pt-program-win 



pt-program. def 
pt-program-j ava . def 
pt-program-unix.def 
pt-program-win. def 



6 
7 
8 
9 
10 
11 
12 
13 
14 



pt-program. def: 

/* type definition info for a "program" product type */ 



dir-source-files 

dir-library-files 

dir-include-files 

file-identification-table 

content-type-index 

service 

... other product type info 



dirs-source.lst 

dirs-iibrary.ist 

dirs-include.lst 

file-identification.tbl 

index-content-types. tbl 

svc-prod-program 
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FIG. 28 



1 


index-content-types.tbl: 




2 


ctype-c-source 


content-c.def 


3 


ctype-c-header 


content-c-h.def 


4 


ctype-csh 


content-csh.def 


5 


ctype-html 


content-html.def 


6 


content-c.def: 




7 


/* type definition info for a 


"c" file type */ 


8 


type 


c-source 


9 


language 


c 


10 


action 


action-c-source 


11 


action-type-index 


index-action-types.tbl 


12 


service 


svc-file-c-source 


13 


... other content type definition info 
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1 


index-action-types.tbl: 
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action-c-source 


action-c-source.def 


3 


action-c-header 


action-c-header.def 


4 


action-csh 


action-csh.def 


5 


action-html 


action-html.def 
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action-c-source.def: 
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parser-type 


internal 
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parser-name 


internal-c 
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service 


svc-action-c-source 
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FIG. 30 



1 idx-makefile-services.tbl: 



2 
3 
4 
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32 



/* services for collections * 
svc-coll-macro-platform 
svc-coll-macro-site 
svc-coll-macro-compiler 
svc-coll-macro-toolnames 
s vc-col I -m acro-f i ie-s uff ix 
svc-coll-target-defaults 



/ 



/* services for products 
svc-prod-program 
svc-prod-program 
svc-prod-program 

svc-prod-library 
svc-prod-iibrary 
svc-prod-library 

/* services for files */ 

svc-file-c-source 

svc-file-c-header 

svc-file-f90 

svc-file-f90-header 

svc-file-f90-module 

/* services for actions *i 
svc-action-c-source 



7 



coll-macro-platform.tpl 

coll-macro-site.tpl 

coll-macro-compiler.tpl 

coll-macro-toolnames.tpl 

coll-macro-file-suffix.tpl 

coll-target-defaults.tpl 



prod_prog_pi.tpI 
prod_prog_os.tpl 
prod_prog_pd.tpl 



prod-lib-pi.tpl 

prod-lib-os.tpl 

prod-lib-pd.tpl 



file-c.tpl 

file-c-header.tpl 
file-f90.tpl 
file-f90-header.tpl 
file-f90-module.tpi 



action-c-source.tpl 



/* services for application tasks */ 
svc-app-chmod app-chmod.tpl 
svc-app-copy-file app-copy-file.tpl 
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FIG. 31 

1 coll-macro-platform.tpl: 

2 # This file defines platform-specific makefile macros 
3 

4 fragment-begin 

5 _marker_ marker-htree copy 

6 # The holding area for shared files and libraries 

7 HTREE=/site/h 

8 fragment-end 
9 

10 fragment-begin 

11 _marker_ marker-macrosi copy 

12 # makefile platform name, virtual platform name 

13 MP=win98.plt 

14 VP=win98 

15 fragment-end 



FIG. 32 

1 coll-macro-site.tpl: 

2 # This file defines site-specific makefile macros 

3 fragment-begin 

4 _marker_ marker-macrosi copy 
5 

6 # places where shared files go 

7 SHARE JDIR=$(HTREE)\share 
8 

9 # places where web pages go 

1 0 HOST_WEB=www. your_domain.com 

11 ... 

12 fragment-end 



20/41 



FIG. 33 

1 coll-macro-toolnames.tpl: 

2 # define macros for various program names 

3 fragment-begin 

4 _marker_ marker-macrosl copy 
5 

6 LS=ls 

7 DIR=dir 

8 RM=rm 

9 CP=cp 

10 ZIP=zip 

11 UNZIP=unzip 

12 CC=gcc 

13 LIB=ld 

14 RMDIR=rm 

15 fragment-end 



FIG. 34 

1 coll-macro-compiler.tpl: 

2 # This file defines compiler options 

3 fragment-begin 

4 _marker_ marker-macrosl copy 
5 

6 # default compiler options 

7 OPT= 

8 DEBUG= 

9 # default linker options 

10 LIBSPATH = $(HTREE)/$(MP) 

11 LDFLAGS=-s 

12 LPP=-L 
13 

14 fragment-end 
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FIG. 35 

1 coll-macro-suffix.tpl: 

2 # defines macros for file suffixes for this platform 

3 fragment-begin 

4 _marker_ marker-macrosl copy 
5 

6 # objects, executables, libraries, archives 

7 0=.o 

8 SO=so 

9 X= 

10 L=.a 

11 A= 

12 AWKS=.awk 

13 SEDS=.sed 

14 LEXS=.I 

15 YACS=.y 

16 CLASS=.class 

17 fragment-end 

FIG. 36 

1 coll-target-defaults.tpl: 

2 # This file defines default makefile targets 

3 fragment-begin 

4 _marker_ marker-targetsO copy 
5 

6 # default targets used by all makefiles 

7 default: build 
8 

9 all: build exports 
10 

11 build: 
12 

1 3 exports: 

14 fragment-end 
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FIG. 37 

0 f* fragment commands */ 

1 fragment-begin / fragment-end 

2 _marker_ marker-name copy 

3 _macro_ macro-name append valuel value2. 

4 _target_ target-name add-deps dep1 dep2 ... 

5 _target_ target-name copy 

6 _target_ target-name copy-force 



FIG. 38 

1 base-template.tpl: 
2 

3 # marker-htree 
4 

5 # marker-macrosi 
6 

7 # marker-targetsO 
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FIG. 39 

1 makefile.out: 
2 

3 # The holding area for shared files and libraries 

4 HTREE=/site/h 

5 # marker-htree 
6 

7 # makefile platform name, virtual platform name 

8 MP=win98.plt 

9 VP=win98 
10 

1 1 # places where shared files go 

12 SHARE_DIR=$(HTREE)\share 

13 ... 

14 LS=ls 

15 DIR=dir 

16 ... 

17 OPT= 

18 DEBUG= 

19 ... 

20 0=0 

21 SO=.so 

22 X= 

23 ... 

24 # marker-macrosl 
25 

26 # default targets used by all makefiles 

27 default: build 
28 

29 all: build exports 
30 

31 build: 
32 

33 exports: 

34 # marker-targetsO 
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FIG. 40 

1 prod-prog-pi.tpl: 

2 # Define platform-independent macros for programs 
3 

4 fragment-begin 

5 _marker_ marker-macrosl copy 

6 # Initialize these macros so they are defined. 

7 ALL_OBJS prod_= 

8 OBJ_PI_prod_= 

9 OBJ_F90_prod_= 

10 OBJ_F90_MOD prod_= 

11 

12 # create one macro to hold all objects 

13 ALL_OBJS_prod_=$(OBJ_PI_prodJ \ 

14 $(OBJ_F90_prodJ $(OBJ_F90_MOD_prodJ 
15 

16 # add marker to anchor linker macro later 

17 # marker-link-cmd 

18 fragment-end 



FIG. 41 

1 prod-prog-os.tpl: 

2 # Define operating system macros for programs 
3 

4 # Adds program name dependency to build target. 

5 fragment-begin 

6 Jarget_ build add_deps _mprod_$(X) 

7 fragment-end 
8 

9 # Adds program name dependency to export target 

10 fragment-begin 

1 1 Jarget_ exports add_deps _mprod_$(X) 

12 fragment-end 
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FIG. 42 

1 prod-prog-pd.tpi: 

2 # Define platform-dependent macros for programs 
3 

4 fragment-begin 

5 _marker_ marker-macrosl copy 

6 # default compiler flags for this platform 

7 CC FLAGS 1= -Wall -ansi -pipe -I. 

8 CCFLAGS2= -I- -c 

9 fragment-end 
10 

11 fragment-begin 

1 2 _marker_ marker-link-cmd copy 

1 3 # linker command for this platform 

14 LDLIBS= 

15 LD prod_=${CC} -o jnprod_ Jib_dirs_ \ 

16 $(ALL_OBJS prod J _lib_names_ 

17 fragment-end 
18 

19 fragment-begin 

20 # add link command to target for program product 

21 Jarget__mprod_$(X) copy 

22 $(LD prodj $(LDFLAGS) 

23 $(CHMOD) 775 _mprod_$(X) 

24 fragment-end 
25 

26 fragment-begin 

27 # add object dependencies to product target 

28 Jarget mprod_$(X) add_deps $(OBJ_PI prodj 

29 fragment-end 
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FIG. 43 



1 


_prod_ 


2 


_mprod_ 


3 


_ptype_ 


4 


_src_file_path_ 


5 


_src_file_name_ 


6 


_src_file_name_no_suf_ 


7 


_target_list_ 


8 


_target_name_ 


9 


_deplist_ 


10 


_incl_dirs_ 


11 


_lib_dirs_ 


12 


_lib_names_ 


13 


_zpln_ 



name of product from cspec 

name of product file on disk 

product type of current product 

source file pathname 

source file filename 

source filename with no suffix 

list of makefile targets 

name of current target 

list of dependent targets 

list of include directories 

list of library directories 

list of library names 

parallel target number 01,02,etc 
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FIG. 44 

1 makefile.out: 

2 ... 

3 # Initialize these macros so they are defined. 

4 ALL_OBJS_myprog= 

5 OBJ_PI_myprog= 

6 OBJ_F90_myprog= 

7 OBJ_F90_MOD_myprog= 
8 

9 # create one macro to hold all objects 

1 0 ALL_OBJS_myprog=$(OBJ_PI_myprog) \ 

1 1 $(OBJ_F90_myprog) $(OBJ_F90_MOD_myprog) 
12 

13 # marker-link-cmd 
14 

15 # marker-macrosl 
16 

1 7 # default targets used by all makefiles 

1 8 default: build 
19 

20 all: build exports 
21 

22 build: myprog 
23 

24 exports: myprog 

25 # marker-targetsO 
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FIG. 45 

1 makefile.out: 

2 ... 

3 # Initialize these macros so they are defined. 

4 ALL_OBJS_myprog= 

5 OBJ_PI_myprog= 

6 ... 

7 # create one macro to hold all objects 

8 ALL_OBJS_myprog=$(OBJ_PI_myprog) ... 

9 ... 

1 0 # linker command for this platform 

11 LDLIBS= 

12 LD_myprog=${CC} -o myprog $(LDLIBS) \ 

13 $(ALL_OBJS_myprog) $(lb) 

14 # marker-link-cmd 

15 ... 

1 6 # default compiler flags for this platform 

17 CCFLAGS1=-Wall-ansi-pipe-l. 

18 CCFLAGS2= -I- -c 

19 # marker-macrosl 

20 ... 

21 build: myprog 
22 

23 exports: myprog 

24 ... 

25 # add link command to target for program product 

26 myprog: $(OBJ_PI_myprog) 

27 $(LD_myprog) $(LDFLAGS) 

28 $(CHMOD) 775 myprog 

29 # marker-targetsO 
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FIG. 46 

1 file-c-source.tpl: 

2 # process files 
3 

4 # add current source file to top src file macro 

5 fragment-begin 

6 _macro_ SRC_C append „srcjile_path_ 

7 fragment-end 
8 

9 # add current source file to product source file macro 

10 fragment-begin 

1 1 _macro_ SRC_C prod_ append _src_file_path_ 

12 fragment-end 



FIG. 47 

1 action-c-source.tpl: 

2 # process files 
3 

4 # add compilation command under C object targets. 

5 fragment-begin 

6 Jarget target_name_$(0) copy 

7 $(CC) $(OPT) $(DEBUG) $(CCFLAGS1 ) \ 

8 _incl_dirs_ $(CCFLAGS2) _src_file_path_ 

9 fragment-end 
10 

11 # add dependency list to C object target. 

12 fragment-begin 

13 Jarget target_name_$(0) add_deps _deplist_ 

14 fragment-end 
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FIG. 48 

1 makefile.out: 

2 ... 

3 SRC_C= ../s/gnulinux2/cmdline.c ... 

4 ... 

5 SRC_C_prod_= ../s/gnulinux2/cmdline.c . . . 

6 ... 

7 # default compiler flags for this platform 

8 CCFLAGS1=-Wall-ansi-pipe-l. 

9 CCFLAGS2= -I- -c 

10 # marker-macros 1 

11 ... 

1 2 # default targets used by all makefiles 

13 default: build 
14 

1 5 all: build exports 
16 

17 build: myprog 
18 

19 exports: myprog 

20 ... 

21 cmdline.o: ../s/pi/cmdline.h ../lib/pi/libfuns.h 

22 $(CC) $(OPT) $(DEBUG) $(CCFLAGS1 ) \ 

23 _incl_dirs_ $(CCFLAGS2) ../s/gnulinux2/cmdline.c 

24 

25 ... 

26 # marker-targetsO 
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collection 
coll-type 
coll-desc 
svc 

end-collection 

product 

prod-type 

libs 

SVC 

end-product 



FIG. 49 

c-my-example 

ct-program 

A fileset example 

svc-coll-cleanup 



myprog 

pt-program 

mylib 

svc-app-copy-file myprog myprog. bak 
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1 cspec: 

2 ... 



FIG. 50 



3 
4 
5 
6 

7 
8 
9 

10 
11 



product 
prod-type 
prod-desc 
end-product 



myprog 
pt-program 

A normal program binary executable. 



product 
prod-type 
prod-desc 
replace-name myprog 
end-product 



myprog-2 
pt-shared-object 

A shared object program executable 



1 2 _prod_ becomes cspec name myprog-so 

13 _mprod_ becomes diskfile name myprog 

14 # add link command to target for program product 

15 _mprod_$(X): 

16 $(LD_prod_) $(LDFLAGS_prodJ 

1 7 $(CHMOD) 775 _mprod_$(X) 



1 8 # link target for product myprog 

19 myprog$(X): 

20 $(LD_myprog) $(LDFLAGS_myprog) 

21 $(CHMOD) 775 myprog$(X) 



22 # link target for product myprog-so 

23 myprog$(SO): 

24 $(LD_myprog-2) $(LDFLAGS_myprog-2) 

25 $(CHMOD) 775 myprog$(SO) 
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FIG. 51 



1 


product-build-order.tbl: 


2 


# define relative build order among products 


3 
4 


pt-initial 


10 


5 


pt-data 


50 


6 


pt-library 


100 


7 


pt-program 


1000 


8 


pt-script 


1000 



FIG. 52 

1 makefile.out: 

2 ... 

3 # dependent targets mylib and myprog appear in proper 

4 # product build order, from left to right 

5 # 

6 build: mylib myprog 
7 

8 mylib: 

9 ... 

1 0 myprog: 

11 ... 
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FIG. 53 

1 file-build-order.tbl: 

2 # define relative build order among file types 
3 

4 ft-resource 10 

5 ft-precompiled-cpp 20 

6 ft-c-source 50 



FIG. 54 

1 makefile.out: 

2 ... 

3 # dependent targets mylib and myprog appear in proper 

4 # product build order, from left to right 

5 # 

6 build: mylib myprog 
7 

8 mylib: 

9 ... 

10 myprog: myresource.rc myprecompiled-header.o cmdline.o 

11 ... 
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FIG. 55 



dirs-include.lst: 



2 dir/gnulinux2 

3 dir/gnulinux2 

4 dir/gnulinux2 

5 dir/gnulinux2 



/site/myteam/include/gnulinux2 
/site/myteam/include/gnulinux 
/site/include/gnulinux2 
/site/include/gnulinux 



FIG. 56 



1 # suppose these are paths to example include files 

2 /site/include/gnulinux2/external-incl-file. h 

3 /site/myteam/include/gnulinux/team-incLh 

4 # include files matched by search rules, in order 

5 /site/myteam/include/gnulinux/team-incl.h 

6 /site/include/gnulinux2/external-incl-file.h 

7 jncLdirs_ = -I /site/myteam/include/gnulinux \ 

... -I /site/include/inux2 

8 makefile. out: 

9 ... 

10 filel.o: ../s/filelc 

1 1 $(CC) $(OPT) $(DEBUG) $(CCFLAGS1 ) \ 

1 2 -I /site/myteam/include/gnulinux -I /site/include/inux2 \ 

13 $(CCFLAGS2)../s/file1.c 
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FIG. 57 



1 dirs-iibrary.lst: 



2 dir/gnulinux2 

3 dir/gnulinux2 

4 dir/gnulinux2 

5 dir/gnulinux2 



/site/myteam/lib/gnulinux2 
/site/myteam/lib/gnulinux 
/site/lib/gnulinux2 
/site/lib/gnulinux 



FIG. 58 



1 # suppose these are paths to example libraries 

2 /site/lib/gnulinux2/gnulinux-lib.a 

3 /site/myteam/lib/gnulinux/team-lib.a 

4 # libs matched by search rules, in order 

5 /site/myteam/Iib/gnulinux/team-Iib.a 

6 /site/lib/gnulinux2/gnulinux-lib.a 

7 _lib_dirs = -L /site/myteam/lib/gnulinux -L /site/lib/inux2 

8 Jib_names_ = -I team-lib. a gnulinux-lib.a 

9 makefile.out: 

10 ... 

1 1 LDjnprog = $(LD) -L /site/myteam/lib/gnulinux \ 

12 ... -L /site/lib/gnulinux2 \ 

13 ... -I team-lib.a -I gnulinux-lib.a 

14 ... 

15 myprog$(X): ... 

16 $(LD_mprog) ... 
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FIG. 59 

1 virtual-platform.tbl: 

2 # 



3 


# 


Specific 


Generic 


Family 


Eve 


4 


# Name 


OS 


OS 


OS 


OS 


5 


# 










6 


gnulinux2.plt 


gnulinux2 


gnulinux 


unix 


Pi 


7 


sol28.plt 


sol28 


sol 


unix 


Pi 


8 


win98.plt 


win98 


win9 


win 


Pi 


9 


win95.plt 


win95 


win9 


win 


Pi 


10 


winnt40.plt 


winnt40 


winnt 


win 


Pi 


11 


win2000.plt 


win2000 


winnt 


win 


Pi 



FIG. 60 

1 # fragment search directories for win98 platform 

2 fragments/win98 

3 fragments/win9 

4 fragments/win 

5 fragments/pi 

6 # fragment search directories for gnulinux 2 platform 

7 fragments/gnulinux2 

8 fragments/gnulinux 

9 fragments/unix 
10 fragments/pi 
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FIG. 61 



1 


collection 


c-my-example 


2 


coll-type 


ct-program 


3 


coll-desc 


Afileset example 


4 


end-collection 




5 


product 


myprog 


6 


prod-type 


pt-program 


7 


libs/pi 


mylib 


8 


libs/gnulinux 


mylib myother-gnulinux-lib 


9 


svc/pi 


svc-prod-name svc arguments 


10 


svc/gnulinux 


svc-prod-name svc args 


11 


svc/win98 


svc-prod-name svc args 


12 


end-product 
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FIG. 62 

1 makefile, out 

2 ... 

3 myprog: file-001.ofile-002,o ... file-100.o 

4 $(LD_mprog) ... 

5 # GNU make parallelism with -jobs argument will compile 

6 #4 files at a time to build the myprog target 

7 # 

8 make -j 4 myprog 

9 # without a parallel make tool, makefile targets must be 

1 0 # generated to offer parallelism, as follows: 

11 # 

12 myprog: myprog-01 myprog-02 myprog-03 myprog-04 

13 myprog-01: file-001 .o file-002.o ... file-025.o 

14 myprog-02: file-026.o file-027.o ... file-050.o 

1 5 myprog-03: file-051 .o file-052.o . . . file-075.o 

16 myprog-04: file-076.o file-077.o ... file-100.o 

17 # now parallel commands can be issued against parallel targets 

18 # running on multiple machines 

19 onmachinel: make myprog-01 

20 on machine2: make myprog-02 

21 ... 

22 # running multiple windows on one machine 

23 in shell window 1 : make myprog-01 

24 in shell window 2: make myprog-02 

25 ... 

26 # or running in the background on one machine 

27 in shell window 1: make myprog-01 & 

28 in shell window 1 : make myprog-02 & 

29 ... 
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FIG. 63 

1 action-c-source.tpl: 

2 # process files 

3 ... 

4 # this line adds the parallelism-specific object file macro to the 

5 # "master" or "top level" object file macro. 

6 fragment-begin 

7 _macro_ OBJ_PI_prod_ append $(OBJ_PI_prod zplnj 

8 fragment-end 
9 

1 0 # this line adds current object file to correct 

1 1 # parallelism-specific object file macro 

12 fragment-begin 

1 3 _macro_ OBJ_PI_prod zpln_ append Jarget_name_$(0) 

14 fragment-end 
15 

16 # this line adds the parallelism-specific object file macro as a 

1 7 # dependency of the parallelism-specific build target. 

18 fragment-begin 

1 9 Jarget_ build_zpln_ add_deps $(OBJ_PI_prod zpln J 

20 fragment-end 



FIG. 64 

1 makefile.out: 

2 ... 

3 OBJ_PI_myprog = file-001 .o file-002.o . . . file-1 OO.o 

4 OBJ_PI_myprog_01 = file-001. ofile-002.o ... file-025.o 

5 OBJ_PI_myprog_02 = file-026.o file-027.o ... file-050.o 

6 ... 

7 build_01: $(OBJ_PI_myprog_01) 

8 ... 

9 build_02: $(OBJ_PI_myprog_02) 
10 ... 
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FIG. 65 

1 makefile.out: 

2 # sequential and parallel targets for multiple products 

3 ... 

4 # target for building all products sequentially 

5 build: build_01 build_02 build_03 

6 ... 

7 # parallel targets for building all products in parallel 

8 build_01: myprog-01 product2-01 product3-01 ... 

9 build_02: myprog-02 product2-02 product3-02 ... 

10 ... 

1 1 # target for building product 'myprog' sequentially 

12 myprog: myprog-01 myprog-02 myprog-03 

13 ... 

14 # parallel targets for building product 'myprog' in parallel 

1 5 myprog-01 : $(OBJ_PI_myprog_01 ) 

16 myprog-02: $(OBJ_PI_myprog_02) 

17 ... 

1 8 # target for building product 'product2' sequentially 

19 product2: product2-01 product2-02 ... 

20 ... 

21 # parallel targets for building product 'product2' in parallel 

22 product2-01: $(OBJ_PI_product2_01) 

23 product2-02: $(OBJ_PI_product2_02) 

24 ... 



